<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Consultas : Gu&iacute;a del Usuario de CodeIgniter</title>

<style type='text/css' media='all'>@import url('../userguide.css');</style>
<link rel='stylesheet' type='text/css' media='all' href='../userguide.css' />

<script type="text/javascript" src="../nav/nav.js"></script>
<script type="text/javascript" src="../nav/prototype.lite.js"></script>
<script type="text/javascript" src="../nav/moo.fx.js"></script>
<script type="text/javascript" src="../nav/user_guide_menu.js"></script>

<meta http-equiv='expires' content='-1' />
<meta http-equiv= 'pragma' content='no-cache' />
<meta name='robots' content='all' />
<meta name='author' content='ExpressionEngine Dev Team' />
<meta name='description' content='Gu&iacute;a del Usuario de CodeIgniter' />

</head>
<body>

<!-- START NAVIGATION -->
<div id="nav"><div id="nav_inner"><script type="text/javascript">create_menu('../');</script></div></div>
<div id="nav2"><a name="top"></a><a href="javascript:void(0);" onclick="myHeight.toggle();"><img src="../images/nav_toggle_darker.jpg" width="154" height="43" border="0" title="Mostrar Tabla de Contenido" alt="Mostrar Tabla de Contenido" /></a></div>
<div id="masthead">
<table cellpadding="0" cellspacing="0" border="0" style="width:100%">
<tr>
<td><h1>Gu&iacute;a del Usuario de CodeIgniter Versi&oacute;n 2.1.1</h1></td>
<td id="breadcrumb_right"><a href="../toc.html">Tabla de Contenido</a></td>
</tr>
</table>
</div>
<!-- END NAVIGATION -->


<!-- START BREADCRUMB -->
<table cellpadding="0" cellspacing="0" border="0" style="width:100%">
<tr>
<td id="breadcrumb">
<a href="http://codeigniter.com/">CodeIgniter</a> &nbsp;&#8250;&nbsp;
<a href="../index.html">Gu&iacute;a del Usuario</a> &nbsp;&#8250;&nbsp;
<a href="index.html">Clase Database</a> &nbsp;&#8250;&nbsp;
Consultas
</td>
<td id="searchbox"><form method="get" action="http://www.google.com/search"><input type="hidden" name="as_sitesearch" id="as_sitesearch" value="escodeigniter.com/guia_usuario/" />Buscar en la Gu&iacute;a del Usuario&nbsp; <input type="text" class="input" style="width:200px;" name="q" id="q" size="31" maxlength="255" value="" />&nbsp;<input type="submit" class="submit" name="sa" value="Go" /></form></td>
</tr>
</table>
<!-- END BREADCRUMB -->



<br clear="all" />


<!-- START CONTENT -->
<div id="content">

<h1>Consultas</h1>

<h2>$this->db->query();</h2>
<p>Para realizar una consulta, utilice la siguiente funci&oacute;n:</p>

<code>$this->db->query('SU CONSULTA AQUI');</code>

<p>La funci&oacute;n <dfn>query()</dfn> devuelve un <strong>objeto</strong> resultante de la base de datos cuando se ejecutan consultas de tipo "lectura", las cuales se pueden usar para <a href="results.html">mostrar sus resultados</a>. Cuando se ejecutan consultas de tipo "escritura" simplemente devuelve VERDADERO o FALSO seg&uacute;n el &eacute;xito o el fracaso. Para la recuperaci&oacute;n de datos se suele asignar t&iacute;picamente la consulta a su propia variable, como esto:</p>

<code><var>$query</var> = $this->db->query('SU CONSULTA AQUI');</code>

<h2>$this->db->simple_query();</h2>
<p>Esta es una versi&oacute;n simplificada de la funci&oacute;n <dfn>$this->db->query()</dfn>. Esto SOLO devuelve VERDADERO/FALSO seg&uacute;n el exito o el fracaso. NO retorna un conjunto de resultados de la base de datos, ni establece el tiempo de la consulta, o compila los datos obligatorios, o almacena su consulta para depuraci&oacute;n. Simplemente le permite realizar una consulta. La mayor&iacute;a de los usuarios raramente suelen usar esta funci&oacute;n.</p>

<h1>Agregar prefijos manualmente a la Base de Datos</h1>
<p>Si ha configurado un prefijo a la base de datos y desea a&ntilde;adirlo manualmente, puede usar lo siguiente.</p>

<p><code>$this-&gt;db-&gt;dbprefix('tablename');<br />
// Salida prefix_tablename</code></p>

<h1>Proteger Identificadores</h1>
<p>En muchas bases de datos es recomendable proteger las tablas y los nombres de los campos - por ejemplo con backticks en MySQL. Las consultas de Active Record estan autom&aacute;ticamente protegidas, sin embargo si necesita proteger manualmente un identificador puede usar:</p>

<p><code>$this-&gt;db-&gt;protect_identifier('table_name');</code></p>

<h1>Escapar Consultas</h1>
<p>Es una muy buena pr&aacute;ctica de seguridad para escapar de sus datos antes de presentarlos en su base de datos. CodeIgniter tiene dos funciones que lo ayudan a hacer esto:</p>

<ol>
</li>
<li><strong>$this->db->escape()</strong> Esta funci&oacute;n determina el tipo de datos a fin de que s&oacute;lo pueda escapar de cadenas de datos. Tambi&eacute;n a&ntilde;ade autom&aacute;ticamente comillas simples alrededor de los datos para que no tenga que:
<code>$sql = "INSERT INTO table (title) VALUES(".$this->db->escape($title).")";</code></li>
<li><strong>$this->db->escape_str()</strong> Esta funci&oacute;n escapa a los datos pasados a la misma, independientemente de su tipo. La mayor&iacute;a de las veces debe usar la funci&oacute;n anterior en lugar de &eacute;sta. Utilice la funci&oacute;n de esta manera:
<code>$sql = "INSERT INTO table (title) VALUES('".$this->db->escape_str($title)."')";</code></li>
</ol>

<h1>Enlazar Consultas</h1>
<p>Enlazar le permite simplificar la sintaxis de la consulta dejando que el sistema ponga las consultas juntas en lugar de usted. Considere el siguiente ejemplo:</p>

<code>
$sql = "SELECT * FROM some_table WHERE id = <var>?</var> AND status = <var>?</var> AND author = <var>?</var>";
<br /><br />
$this->db->query($sql, array(3, 'live', 'Rick'));
</code>

<p>Los signos de interrogaci&oacute;n en la consulta son autom&aacute;ticamente reemplazados con los valores en el arreglo en el segundo par&aacute;metro de la funci&oacute;n de consulta.</p>

<p class="important">El beneficio secundario de la utilizaci&oacute;n de enlazar es que los valores son autom&aacute;ticamente escapados, produciendo consultas mas seguras. No tiene que acordarse de escapar los datos manualmente, el motor lo hace autom&aacute;ticamente para usted.</p>

</div>
<!-- END CONTENT -->


<div id="footer">
<p>
Tema anterior:&nbsp;&nbsp;<a href="connecting.html">Conectar a una Base de Datos</a>
&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
<a href="#top">Subir</a>&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
<a href="../index.html">Gu&iacute;a del Usuario</a>&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
Pr&oacute;ximo tema:&nbsp;&nbsp;<a href="results.html">Generar Resultados de Consultas</a>
</p>
<p><a href="http://codeigniter.com">CodeIgniter</a> &nbsp;&middot;&nbsp; Copyright &#169; 2006 - 2011 &nbsp;&middot;&nbsp; <a href="http://ellislab.com/">EllisLab, Inc.</a></p>
</div>

</body>
</html>